home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / comunic / zcomm.zip / ZCOMMDOC.AA < prev    next >
Text File  |  1993-11-27  |  68KB  |  1,771 lines
  1.  
  2.  
  3.                                   Chuck Forsberg
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                  User Manual for
  14.                                       ZCOMM
  15.  
  16.                           Universal Line Printer Edition
  17.  
  18.  
  19.                           ZCOMM Communications Software
  20.  
  21.                                     Featuring
  22.                           TurboLearn(TM) Script Writer,
  23.                Cybernetic Data Recovery(TM), Error Containment(TM),
  24.                                        and
  25.                                  OverThruster(TM)
  26.  
  27.                    User Supported Communications Software Tools
  28.  
  29.  
  30.  
  31.                                  User Manual for
  32.                                       ZCOMM
  33.                           Universal Line Printer Edition
  34.  
  35.  
  36.                         Copyright 1992 Omen Technology Inc
  37.                                All Rights Reserved
  38.  
  39.  
  40.  
  41.  
  42.                            Omen Technology Incorporated
  43.  
  44.                           The High Reliability Software
  45.  
  46.                           Box 4681 Portland Oregon 97208
  47.                             VOICE: 503-621-3406 :VOICE
  48.                 TeleGodzilla Modem: 621-3746 Speed 1200,2400,19200
  49.                  Compuserve:70007,2304  GEnie:CAF  BIX:cforsberg
  50.                         UUCP: ...!tektronix!reed!omen!caf
  51.           Copyright 1984, 1992  Omen Technology INC All Rights Reserved
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.       (C) 1993 Omen Tech Inc                                      Chapter 0
  59.  
  60.  
  61.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  62.       ZCOMM User Manual                                                    2
  63.  
  64.       1.  INTRODUCTION
  65.  
  66.                                       ZCOMM
  67.                  Industrial Stength Communications Shareware(TM)
  68.  
  69.       #---------------------------------------------------------------------#
  70.       #        Professional-YAM  Copyright 1991 Omen Technology INC         #**
  71.       #                                                                     #**
  72.       #                           ZMODEM RECEIVE                            #**
  73.       #                                                                     #**
  74.       #   File  pcmagc.dmp                                1 of       5      #**
  75.       #                                                                     #**
  76.       #   Current     43520 of   43520      Total     43520 of   999879     #**
  77.       #                                                                     #**
  78.       #   This   ##################################################         #**
  79.       #         0------------------------50------------------------100%     #**
  80.       #   Total  ##-                                                        #**
  81.       #   State  START FILENAME COMPARE DATA CORRECTING FINISH WAIT         #**
  82.       #   Throughput    8704   Retries     0   Time left     2 min          #**
  83.       #   Connect ET   13:09   Time    13:18   Modem status                 #**
  84.       #                                                                     #**
  85.       #                                                                     #**
  86.       #   Packet LEN    43520  TRANSPORT   COMPRESSED     DATA BINARY       #**
  87.       #   Subpkt LEN      512  Window SIZ                                   #**
  88.       #              ALT-F Cancel File   ALT-B Cancel Batch                 #**
  89.       #                                                                     #**
  90.       #---------------------------------------------------------------------#**
  91.        ************************************************************************
  92.  
  93.       38kbps ZMODEM-90(TM) file download from a Unix system.  ZMODEM-90(TM)
  94.       compression yields 87kbps effective speed on the[1] PC Magazine
  95.       Compressible File Benchmark.  When PC Magazine tested communications
  96.       programs with ZMODEM, the fastest transfer they remember seeing was a
  97.       wimpy 38.58 kilobits/sec from Hyper/Access/5, not the 87 kilobits/sec
  98.       shown above.  That's what happens when you don't look at the manual!
  99.  
  100.  
  101.       ZCOMM helps collect, control, and transmit information with a minimum
  102.       of time, hassle, and expense.  Concise commands and unobtrusive
  103.       displays facilitate telecommunications instead of distracting.
  104.  
  105.       When it comes to file transfers, just remember who wrote YMODEM and
  106.       ZMODEM.  Two decades of telecommunications knowledge are distilled in
  107.       ZCOMM.
  108.  
  109.  
  110.       __________
  111.  
  112.        1. Page 159, April 30 1991 PC Magazine.  File obtained from PC
  113.           Magazine with permission.
  114.  
  115.  
  116.  
  117.       (C) 1993 Omen Tech Inc                          Chapter 1 Introduction
  118.  
  119.  
  120.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  121.       ZCOMM User Manual                                                    3
  122.  
  123.  
  124.                          State of the Art File Transfers
  125.  
  126.       "ZMODEM is the overall winner"
  127.                              -BYTE Magazine, Feb 1989
  128.  
  129.       "Professional-YAM showed the fastest file transfer times"
  130.                                 -PC Magazine, 1991
  131.  
  132.       Two decades of communications experience are distilled in ZCOMM.
  133.       ZCOMM transfers files quickly and surely under real world conditions,
  134.       not just across tabletops.  Unsolicited customer testimonials
  135.       chronicle accurate file transfers under conditions that crash other
  136.       programs, thanks to Omen Technology's Cybernetic Data Recovery(TM)
  137.       logic enhancements and rigorous stress testing.
  138.  
  139.       How often has your modem disconnected when you were within a few bytes
  140.       of finishing a long, expensive file transfer?  With ZMODEM-90(TM) you
  141.       can resume the transfer from where you were cut off, without wasted
  142.       time or extra phone charges.  If the transfer aborted because you ran
  143.       out of disk space, ZMODEM can recover from that too!
  144.  
  145.       ZMODEM transfers files and commands with a user friendly interface.
  146.       Unlike traditional protocols, only one command or menu choice is
  147.       needed to transfer files or download commands.
  148.  
  149.       "Pro-YAM's AutoDownload feature for ZMODEM (and KERMIT) has got me
  150.       completely addicted."
  151.  
  152.       ZMODEM protects your data with a 32 bit CRC, five orders of magnitude
  153.       more accurate than the CRC-16 used by other protocols, and billions of
  154.       times more sensitive than XMODEM checksum.  Unlike "me too" protocols
  155.       developed to compete with ZMODEM, all ZMODEM messages are protected
  156.       with CRC.
  157.  
  158.       ZMODEM provides high throughput and full integrity with timesharing
  159.       systems, high speed modems, and packet switched networks.  Unlike
  160.       other protocols, ZMODEM's does not compromise reliability to get high
  161.       speed.
  162.  
  163.       Omen Technology's ZMODEM-90(TM) extensions accelerate transfers and
  164.       enhance flexibility.
  165.  
  166.       Pro-YAM's ZMODEM compression provides spectacular throughput increases
  167.       on suitable files, significantly faster than other protocols tested
  168.       with the PC Magazine Compressible Test File.
  169.  
  170.       Other ZMODEM features include text file translation, selective
  171.       transfer of modified files, and remote file maintenance.  A single
  172.       command can update an entire directory tree, creating new
  173.       subdirectories as necessary.
  174.  
  175.  
  176.       (C) 1993 Omen Tech Inc                          Chapter 1 Introduction
  177.  
  178.  
  179.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  180.       ZCOMM User Manual                                                    4
  181.  
  182.       Security authentication* disables Trojan Horse attacks.
  183.  
  184.       ZMODEM supports world wide operations by preserving the exact file
  185.       contents and modification date, unaffected by crossing time zones.
  186.  
  187.       Omen Technology provides complimentary Unix and VAX/VMS ZMODEM servers
  188.       in source and binary formats.
  189.  
  190.       "Here's the simple fact. Zmodem is the state-of-the-art protocol for
  191.       microcomputers.  It's the protocol of choice.  Forget the old dogs.
  192.       It's fast and bullet-proof."
  193.                -John C. Dvorak, INSIDE TRACK, PC Magazine June 1989
  194.  
  195.       "without doubt the number one protocol"
  196.                         -Boardwatch Magazine January 1990
  197.  
  198.       Competitors hype their undocumented proprietary protocols; experienced
  199.       BBS operators know ZMODEM is the only high performance protocol that
  200.       survives on the streets.  ZMODEM's convenience, speed and reliability
  201.       have made it the protocol of choice for bulletin boards, BIX, GEnie,
  202.       Portal, Delphi, Unison, and other information utilities.
  203.  
  204.                       XMODEM: Lingua Franca for Old Programs
  205.  
  206.       ZCOMM supports Ward Christensen's XMODEM protocol with Cybernetic Data
  207.       Recovery(TM) and automatic file name generation.  Omen Technology's
  208.       exclusive Cybernetic Data Recovery transfers files under conditions
  209.       that crash other programs.
  210.  
  211.        + XMODEM CRC-16 is more accurate than simple checksum.  But even with
  212.          CRC-16, an error of just two bits can corrupt data sent with
  213.          XMODEM.  Cybernetic Data Recovery catches and corrects many errors
  214.          that confound other programs.
  215.  
  216.        + True YMODEM(TM) batch file transfers preserve the exact file name,
  217.          file length and creation date.
  218.  
  219.        + XMODEM-1k and YMODEM-1k 1024 byte packets increase XMODEM
  220.          throughput.
  221.  
  222.                            Kermit: Rx for Brain Damage
  223.  
  224.       Kermit transfers ASCII and binary files with IBM, CDC, Cray, ICL,
  225.       Harris, Honeywell, Pr1me, Tandem, Univac and other traditional
  226.       mainframes that do not support XMODEM.
  227.  
  228.       While not as fast as ZMODEM, Kermit is more reliable than XMODEM.
  229.       ZCOMM's 16 bit Kermit CRC is thousands of times more accurate than
  230.       other programs' 6 bit checksum.
  231.  
  232.  
  233.  
  234.  
  235.       (C) 1993 Omen Tech Inc                          Chapter 1 Introduction
  236.  
  237.  
  238.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  239.       ZCOMM User Manual                                                    5
  240.  
  241.        + Convenient Kermit AutoDownload deciphers the sending program's
  242.          Kermit dialect, saving keystrokes and frustration.  (Dialect
  243.          incompatibilities often confound Kermit users.)
  244.  
  245.        + Long Packet Kermit speeds file transfers with IBM, CDC, and Cray
  246.          mainframe systems.  Sliding Windows are also supported.  Kermit
  247.          Server Access functions support low cost networking.
  248.  
  249.                           Swiss Army Knife for Protocols
  250.  
  251.  
  252.        + Extended Quick-B streaming protocol slashes CompuServe download
  253.          costs up to 60 per cent or more.
  254.  
  255.        + OverThruster(TM) accelerator speeds XMODEM and YMODEM downloads
  256.  
  257.        + ZCOMM supports bulletin boards and traditional programs with
  258.          Telink/FIDO, MODEM7 batch, WXMODEM (Windowed XMODEM), and SEAlink
  259.          file transfer protocols.
  260.  
  261.                                    Data Capture
  262.  
  263.       ZCOMM's Full-Time Capture Buffer(TM) saves scrolled data other
  264.       programs lose.  You can scroll, page, and string search to cut and
  265.       paste captured information.
  266.  
  267.       Omen's Error Containment(TM) technology minimizes errors caused by
  268.       line hits and their effects on automatic scripts.
  269.  
  270.       ZCOMM captures text with many choices of parity bit and control
  271.       character editing.  ZCOMM can capture binary data without protocols.
  272.       ZCOMM does not limit the length of captured files.
  273.  
  274.  
  275.                              Controlling Information
  276.  
  277.       ZCOMM's Full-Time Capture Buffer(TM) lets you flip back and forth or
  278.       search, scanning two hundred messages from bulletin boards in a couple
  279.       of minutes.  (It has to be seen to be believed.) To compose a reply,
  280.       call your favorite editor (the one you've already learned!) as a
  281.       subroutine without losing your place.
  282.  
  283.       ZCOMM's high speed screen driver- makes life pleasant:
  284.  
  285.       + Easy on the eyes: ZCOMM supports No Flicker displays, up to 450 per
  286.         cent faster than DOS
  287.  
  288.       + VT220, VT102, VT100, Wyse, TTY 5425, ANSI, Z19, VT52, TI 940, IBM
  289.         3101, Televideo 9xx, and ADM3a emulation.
  290.  
  291.  
  292.  
  293.  
  294.       (C) 1993 Omen Tech Inc                          Chapter 1 Introduction
  295.  
  296.  
  297.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  298.       ZCOMM User Manual                                                    6
  299.  
  300.       + Supports VTxxx and Wyse "Printer Controller Mode".
  301.  
  302.       + Supports 132 columns and advanced displays (114x60, etc.)
  303.  
  304.       + VT100 character graphics and keyboard mapping support "visual"
  305.         programs.  Unlike most "VT100" emulators, ZCOMM correctly displays
  306.         EDT, All-In-1, SCO setcolor, and DEC Store on an XT even at 19200
  307.         baud.
  308.  
  309.       + Hardcopy Terminal Emulation previews printer output.
  310.  
  311.       + Visual (silent) bell preserves domestic tranquillity
  312.  
  313.       + Settable number of lines and columns, border color, default colors,
  314.         autowrap, keyboard mapping enable.
  315.  
  316.       Full pathnames, directories, and wildcards support file transfers and
  317.       utility commands.
  318.  
  319.       ZCOMM can search files for lines matching a string, insensitive to
  320.       case.
  321.  
  322.  
  323.                              Transmitting Information
  324.  
  325.  
  326.       + Dual stack Command Recall saves your keyboarded host commands in a
  327.         history file for search, recall, editing, and reentry.
  328.       + Convenient Split Screen option- allows responsive local editing of
  329.         input lines before transmission.
  330.       + A rich palette of editing and timing modes permit file and message
  331.         upload, even to fussy microcomputer Bulletin Boards.
  332.       + Remote access for file transfers and DOS program execution with baud
  333.         rate detection and three passworded security levels.
  334.       + Outcall Queue intersperses scheduled outgoing calls with incoming
  335.         messages on one modem line.
  336.  
  337.  
  338.       1.1  Other Features
  339.  
  340.  
  341.       Interrupt driven modem input allows High speed operation with file
  342.       transfer and conversational terminal operation at 19200 bps and above.
  343.       ZCOMM fully exploits advanced features of the new UART chips for best
  344.       operation at high speeds.
  345.  
  346.       A real-time status line displays column, row, time, elapsed time,
  347.       transmission speed, and other important information.
  348.  
  349.       Soft keys provide convenient execution of common commands.
  350.  
  351.  
  352.  
  353.       (C) 1993 Omen Tech Inc                          Chapter 1 Introduction
  354.  
  355.  
  356.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  357.       ZCOMM User Manual                                                    7
  358.  
  359.       ZCOMM is written in C for performance, portability and
  360.       maintainability.  ZCOMM loads quickly from a moderately sized
  361.       executable file with no cumbersome overlays.
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.       (C) 1993 Omen Tech Inc                          Chapter 1 Registration
  413.  
  414.  
  415.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  416.       ZCOMM User Manual                                                    8
  417.  
  418.       2.  ZCOMM REGISTRATION
  419.  
  420.       ZCOMM is a user supported program developed and supported by Chuck
  421.       Forsberg.  ZCOMM is not and never has been public domain.
  422.  
  423.       Registration buys you:
  424.  
  425.          + Your own unique ZCOMM Serial Number Password (ZSNP).  Your ZSNP
  426.            may be applied to copies of ZCOMM to be run on a single machine.
  427.  
  428.               + Serialized of ZCOMM deactivates the registration request
  429.                 display and the pause afterwards.
  430.  
  431.               + Serialization activates the egrep, egrepm, expand, split,
  432.                 and ss commands and the outcall queue.  Features denoted
  433.                 with ** are available in serialized copies of ZCOMM.
  434.  
  435.               + Serialization more than doubles the circular buffer size.
  436.  
  437.          + A software disk with the current version of ZCOMM, the putsnp
  438.            program to serialize your copy of ZCOMM with your ZSNP, and the
  439.            tree structured "flash-up" help processor and help file included
  440.            in ZCOMMHLP.ARC.
  441.  
  442.          + The complete Professional-YAM User Manual, more than 200 Typeset
  443.            pages, with many chapters not included here, ready for insertion
  444.            into a PC size binder.
  445.  
  446.          + The Pro-YAM Crib Sheet.
  447.  
  448.          + A ZCOMM registration is worth $40.00 when upgrading to
  449.            Professional-YAM.  The $99.00 upgrade includes the Pro-YAM
  450.            software disks and license.  You will already have the manual
  451.            from your ZCOMM registration package.
  452.  
  453.          + A warm fuzzy feeling arising from the knowledge you have
  454.            supported the advancement of ZMODEM.
  455.  
  456.       REGISTRATION DETAILS:
  457.  
  458.          + Basic registration (ZSNP, disk, manual pages): $40.00
  459.  
  460.          + Optional Custom Binder: $10.00
  461.  
  462.          + Optional 3.5 inch diskette: $5.00
  463.  
  464.          + Domestic/Canada Surface Shipping: Free with prepaid orders
  465.  
  466.          + International Air Mail (most countries): $15.00[1]
  467.  
  468.  
  469.  
  470.  
  471.       (C) 1993 Omen Tech Inc                          Chapter 2 Registration
  472.  
  473.  
  474.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  475.       ZCOMM User Manual                                                    9
  476.  
  477.          + Optional Domestic UPS Second Day AIR: $5.00
  478.  
  479.          + Credit Card/C.O.D. S&H:  $5.00
  480.  
  481.       Don't bother scrounging for an envelope, use the INSTANT MAILER
  482.       included in this archive!
  483.  
  484.  
  485.       2.1  Legal Necessities
  486.  
  487.       ZCOMM may not be modified, patched, hacked, disassembled, decompiled,
  488.       or otherwise reverse engineered, or sold, without prior written
  489.       permission by Omen Technology Inc.  This prohibition applies to any
  490.       theft of the intellectual property and trade secrets contained in
  491.       ZCOMM by decompilation, disassembly, or any other form of reverse
  492.       engineering including but not limited to profiling, tracing, data
  493.       analysis, or monitoring the operation of ZCOMM.
  494.  
  495.       The only legitimate way to disable the opening advertisement in ZCOMM
  496.       is to insert an authorized SNP obtained from Omen Technology into
  497.       ZCOMM with the putsnp program.  Any other suppression or modification
  498.       of the opening screen is illegal, unethical, and prohibited.
  499.  
  500.       Distribution of programs and/or instructions on how to modify, patch,
  501.       disassemble, decompile, or otherwise reverse engineer ZCOMM without
  502.       prior written permission by Omen Technology Inc is a theft of services
  503.       and a violation of federal copyright law, and will be referred to the
  504.       FBI for investigation and prosecution under federal conspiracy
  505.       statutes.  Applicable RICO law provides for treble damages and
  506.       recovery of attorney's fees.
  507.  
  508.       Distribution of ZCOMM in any medium without this documentation file
  509.       constitutes an unauthorized modification.
  510.  
  511.       Students may use unregistered copies of ZCOMM in the discharge of
  512.       assigned coursework for the duration of the course without obligation
  513.       to register.  Otherwise, individuals may use ZCOMM with only a moral
  514.       obligation to register their copy with Omen Technology once they find
  515.       it useful.  You may distribute the unmodified ZCOMM*.ARC archive
  516.       files[2] to as many as you wish, or post them on bulletin boards, etc.
  517.       Businesses must register their copies of ZCOMM.
  518.  
  519.  
  520.  
  521.       ______________________________________________________________________
  522.  
  523.        1. $25.00 to Australia etc. if binder included due to higher cost.
  524.  
  525.        2. The archives may be converted to other storage or archive formats,
  526.           including "zipping", provided no files are modified or removed.
  527.  
  528.  
  529.  
  530.       (C) 1993 Omen Tech Inc                          Chapter 2 Registration
  531.  
  532.  
  533.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  534.       ZCOMM User Manual                                                   10
  535.  
  536.       3.  ZCOMM's Big Brother
  537.  
  538.       ZCOMM is the Little Brother of Professional-YAM.  As powerful as ZCOMM
  539.       is, more powerful than other user supported software, it pales beside
  540.       Omen Technology's commercial Professional-YAM software.
  541.  
  542.       Pro-YAM's TurboDial(TM) script language provides state of the art real
  543.       time pattern recognition, "regular expiression" string parsing, script
  544.       development aids, script encryption, queue management, extensive
  545.       logging facilities, and finely tuned security control unmatched in the
  546.       industry.
  547.  
  548.       Fortune 500 corporations use these exclusive features to support large
  549.       PC based telecommunications projects involving attended and unattended
  550.       operation.
  551.  
  552.       Specialized utility commands allow Pro-YAM and a PC or DG/One portable
  553.       to replace data line monitors in many applications.  Pro-YAM supports
  554.       Echoplex uploads and high speed data dumps in addition to the uniquely
  555.       accurate and robust XMODEM, YMODEM, ZMODEM, and Kermit protocol
  556.       transfers shared with ZCOMM.  Pro-YAM has many powerful utility
  557.       commands that earn it the sobriquet Integrated Communications Tools.
  558.  
  559.       Pro-YAM is available with the Tymnet X.PC link level protocol for
  560.       multiple, concurrent data transfers.
  561.  
  562.       Omen Technology also markets highly compatible Unix and Xenix flavors
  563.       of Pro-YAM.
  564.  
  565.       Omen Technology's Demand Upgrade(TM) technology and small company
  566.       responsiveness meet the support needs of a growing base of demanding
  567.       customers.
  568.  
  569.       Professional-YAM is a superset of ZCOMM; applications and scripts
  570.       developed on ZCOMM will operate with Pro-YAM.
  571.  
  572.       This ZCOMM manual omits descriptions of many Pro-YAM features not
  573.       included in ZCOMM.  The special symbol * denotes Pro-YAM features not
  574.       included in ZCOMM.
  575.  
  576.       Pro-YAM features not included in ZCOMM include X.PC, encryption,
  577.       CryptoScript(TM) capability, Password Guardian(TM), logs, the ap, apd,
  578.       fget, fput, kbdmon, link, on, portx, purgek, quit, restime, restrict,
  579.       timestamp, and trs commands, and certain vertical application and
  580.       security related features.  (Newer versions of ZCOMM include the
  581.       logging facility.)
  582.  
  583.       In some places you will see references to a fake Chapter 99.  Pro-YAM
  584.       manual chapters not included in this document are designated by
  585.       Chapter 99.
  586.  
  587.  
  588.  
  589.       (C) 1993 Omen Tech Inc                                 Chapter 3 ZCOMM
  590.  
  591.  
  592.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  593.       ZCOMM User Manual                                                   11
  594.  
  595.       ZCOMM registration can be upgraded to Pro-YAM as described in the
  596.       previous chapter.
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.       (C) 1993 Omen Tech Inc           Chapter 3 Flavors of Professional-YAM
  649.  
  650.  
  651.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  652.       ZCOMM User Manual                                                   12
  653.  
  654.       4.  FLAVORS OF Professional-YAM
  655.  
  656.       4.1  IBM PC Family and Clones
  657.  
  658.       YAM and ZCOMM run under PC-DOS and compatible operating systems using
  659.       PC compatible 8250 family serial ports.  They exploit the new Intel
  660.       82510 and National NS16550AN serial interface integrated circuits for
  661.       improved high speed operation, especially with memory resident
  662.       software and extended memory ramdisks.
  663.  
  664.       YAMXPC supports the Tymnet X.PC packet protocol.  This version uses
  665.       the Tymnet Packet Driver and will not initialize unless the packet
  666.       driver has been loaded.  The X.PC version lacks the bdump and link
  667.       commands.  The !~ command does not allow DOS subprograms to access the
  668.       serial line with the DOS ctty command.
  669.  
  670.       YAM is also available for OS/2 protected mode.
  671.  
  672.       4.2  Xenix/Unix
  673.  
  674.       Pro-YAM for 32 bit Unix systems supports a number of advanced
  675.       features, including X windows[1] large memory, recursive wild card
  676.       expansions and ZMODEM transfers with RLE or LZW data compression.
  677.       Unix and Xenix flavors of Pro-YAM reflect the deep fundamental
  678.       differences between single tasking PC-DOS and Xenix.  Notable
  679.       differences are in keyboard handling, screen emulation, and real-time
  680.       aspects.  Properly written TurboDial(TM) Scripts may be used with any
  681.       flavor of Pro-YAM.  Omen Technology provides binary executables for
  682.       SCO System V Xenix (286 and 386) and Interactive Systems 386/ix.  The
  683.       386/ix flavor supports Microport SYS V/386 and similar systems.
  684.  
  685.       Please contact Omen Technology for reasonably priced source code for
  686.       other versions of Unix.
  687.  
  688.       4.3  VAX/VMS
  689.  
  690.       VAX/VMS Professional-YAM supports dial out applications with
  691.       functionality similar to Unix flavors.  Popular VMS record types are
  692.       supported.
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.       __________
  702.  
  703.        1. Under xterm(1).
  704.  
  705.  
  706.  
  707.       (C) 1993 Omen Tech Inc           Chapter 4 Flavors of Professional-YAM
  708.  
  709.  
  710.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  711.       ZCOMM User Manual                                                   13
  712.  
  713.       4.4  ZCOMM
  714.  
  715.       ZCOMM is a shareware subset of Pro-YAM available for PC-DOS.  It lacks
  716.       the ap, apd, fget, fput, link, kbdmon, obey, on, quit, purgek,
  717.       restime, restrict, timestamp, and trs commands.  Arbitrary variable
  718.       names and security features are not supported.  Certain commands and
  719.       features are available only in registered copies.  The special symbol
  720.       * denotes features not included in ZCOMM.  Features denoted with **
  721.       are available in registered copies of ZCOMM.
  722.  
  723.       Some ZCOMM users choose to upgrade to Professional-YAM.  Omen's ZCOMM
  724.       to Pro-YAM upgrade policy protects your investment in ZCOMM
  725.       registration.  The ZCOMM to Pro-YAM upgrade consists of a Pro-YAM
  726.       serial number and diskette set.  The $99.00 price is the same as the
  727.       difference between Pro-YAM purchase and ZCOMM registration.
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.       (C) 1993 Omen Tech Inc                     Chapter 4 Design Philosophy
  767.  
  768.  
  769.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  770.       ZCOMM User Manual                                                   14
  771.  
  772.       5.  DESIGN PHILOSOPHY
  773.  
  774.       ZCOMM is a Communications Tool.  Once learned, ZCOMM's command
  775.       interface is more powerful, faster, and less cumbersome than a menu
  776.       interface.  Indeed, menus comprehensive enough to describe all the
  777.       nuances of ZCOMM's capabilities would take up more memory than most
  778.       microcomputers can afford.  In addition, remote operation of ZCOMM
  779.       would be excruciatingly slow due to transmission delays displaying the
  780.       appropriate menu pages.
  781.  
  782.       ZCOMM's look and feel has been influenced by the MODEM series of
  783.       programs, the Unix(TM) Operating System, the Berkeley Editor (vi),
  784.       CP/M(TM), PC-DOS, and ANSI standards.
  785.  
  786.       Function keys F1 and F2 have been assigned with a logical grouping.
  787.       Wherever meaningful, F1 exits from a function, and F2 enters the
  788.       logical "next" function.  From the command prompt, F2 enters the term
  789.       function, and from there another F2 enters the review function.  Once
  790.       in the review function (assuming it was called from the term
  791.       function), F1 exits back to the term function, from where another F1
  792.       exits to the command prompt.
  793.  
  794.       Another ethic guiding ZCOMM's design is respect for the user's
  795.       information.  The user's data is, after all, precisely what a modem
  796.       program is all about.  Status information is limited to one CRT line
  797.       to allow maximum screen size for data.  Fancy display modes such as
  798.       reverse video are used sparingly to avoid distracting from the user's
  799.       work.
  800.  
  801.       If you seek a video arcade modem game, ZCOMM will disappoint you.
  802.  
  803.       5.1  Circular Buffer
  804.  
  805.       The circular buffer remotely resembles the linear "capture buffer"
  806.       used by other modem programs.  Many ZCOMM commands involve the
  807.       circular buffer, including the t, f, wait, ki, kill, w, review, and
  808.       close commands.
  809.  
  810.       The term function uses the circular buffer as a first in, first out
  811.       (FIFO) buffer for data arriving from the remote.  The circular
  812.       organization of this buffer makes the most recent data always
  813.       available for review and arbitrary writing to disk files.
  814.  
  815.       When the circular buffer has been filled and the XOFF character sent
  816.       to the remote, ZCOMM writes the contents of the circular buffer to the
  817.       capture file if a capture file has been opened.  ZCOMM then checks
  818.       whether any characters remain to be written to the printer.  When both
  819.       of these checks are satisfied, ZCOMM then sends an XON character to
  820.       the remote to resume the transmission of data.
  821.  
  822.       Keyboarding ALT-W or enabling j term option writes the contents of the
  823.  
  824.  
  825.       (C) 1993 Omen Tech Inc                       Chapter 5 Circular Buffer
  826.  
  827.  
  828.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  829.       ZCOMM User Manual                                                   15
  830.  
  831.       circular buffer to the capture file without waiting for the circular
  832.       buffer to fill up first.
  833.  
  834.       The large storage capacity of the circular buffer may be used to
  835.       review the most recent data captured from the remote.  The review
  836.       commands lets you page back and forth through the data captured from
  837.       the remote.  Forward and backward string searches make it easy to
  838.       locate important text.  The review commands also let you save segments
  839.       of the circular buffer to disk (cut and paste).  Scripts can search
  840.       and mark text captured from the remote with the full power of regular
  841.       expression pattern matching.  These commands will be explained later.
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.       (C) 1993 Omen Tech Inc                         Chapter 5 Rosetta Stone
  885.  
  886.  
  887.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  888.       ZCOMM User Manual                                                   16
  889.  
  890.       6.  ROSETTA STONE
  891.  
  892.       Alphanumeric An alphanumeric character is either a letter or a decimal
  893.           digit 0 to 9.
  894.  
  895.       Baud A baud is a signaling unit conveying one or more bits of
  896.           information.  Baudrate is commonly (and usually incorrectly)
  897.           interchanged with bits per second.
  898.  
  899.       BPS is an abbreviation for "bits per second", a measure of
  900.           transmission speed.  ASCII Asynchronous transmission generally
  901.           uses 10 bits to transmit each character, so the speed in
  902.           characters per second is one tenth the speed measured in bits per
  903.           second.
  904.  
  905.       Capture The term function captures data from the remote into the
  906.           circular buffer.  This data may be paged back and forth with the
  907.           review function, or written to a disk file.
  908.  
  909.       Character Escape is a sequence of characters initiated by a backslash
  910.           character used to represent a control character or programmable
  911.           string using printable characters.  Character escapes are
  912.           described in Chapter 26.
  913.  
  914.       CPMEOF A control character (hex 1A) added to the end of text files by
  915.           traditional microcomputer programs.  This practice was popular
  916.           with the Digital Research CP/M 8 bit operating system.
  917.  
  918.       Crash Recovery(TM) refers to the ZMODEM File Transfer Protocol's
  919.           ability to resume file transfers that have been interrupted by a
  920.           line disconnect from the point where the transfer was interrupted.
  921.  
  922.       Cyclical Redundancy Check (CRC) is a datum (16 or 32 bits) generated
  923.           by a cyclic code.  The CRC-16 extension to the Ward Christensen
  924.           XMODEM protocol provides a higher level of data integrity than the
  925.           original XMODEM checksum.  A good CRC-16 guarantees detection of
  926.           all single and double bit errors,  all errors with an odd number
  927.           of error bits, all burst errors of length 16 or less, 99.9969% of
  928.           all 17-bit error bursts, and 99.9984 per cent of all possible
  929.           longer error bursts.  The actual performance may be better because
  930.           errors that sneak by CRC-16 are often detected by ZCOMM's
  931.           Cybernetic Data Recovery(TM).
  932.  
  933.           ZMODEM's 32 bit CRC provides five orders of magnitude more
  934.           accurate error detection than XMODEM's CRC-16.  It is a billion
  935.           times more accurate than XMODEM's 8 bit checksum.
  936.  
  937.       Default is a choice a program makes for you if you do not explicitly
  938.           make a contrary choice.
  939.  
  940.  
  941.  
  942.  
  943.       (C) 1993 Omen Tech Inc                         Chapter 6 Rosetta Stone
  944.  
  945.  
  946.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  947.       ZCOMM User Manual                                                   17
  948.  
  949.       Download is the transfer of data from the host system down to your
  950.           computer.
  951.  
  952.       DCE meand Data Communications Equipment.  "DCE speed" refers to the
  953.           transmission speed between modems.
  954.  
  955.       DTE meand Data Terminal Equipment.  "DTE speed" refers to the
  956.           transmission speed between modem and the Data Terminal Equipment
  957.           (computer).
  958.  
  959.       DTR is an abbreviation for Data Terminal Ready.  Data Terminal Ready
  960.           is a signal sent by the computer to the modem to condition it to
  961.           accept commands or answer an incoming call.  When DTR is "dropped"
  962.           (switched off), the modem should disconnect from the line.
  963.  
  964.       Execute When a string parameter is executed, it is normally sent to
  965.           the remote (modem).  If it begins with "@", the remainder is
  966.           executed as a ZCOMM command.
  967.  
  968.       Filespec Some ZCOMM commands instruct a remote Kermit server program
  969.           to send, receive, print, type, or delete one or more files.  The
  970.           syntax of this specification is defined by the remote Kermit
  971.           server program, not ZCOMM.  If filespec contains spaces, filespec
  972.           must be enclosed by double quotes.
  973.  
  974.       Flow Control restrains the speed of transmission to prevent loss of
  975.           data when a fast sender must send to a slower receiver.  Hardware
  976.           signals, control characters, and protocol handshakes can be used
  977.           to provide restraint, singly or in combinations.
  978.  
  979.           SEE ALSO: handshake command, zmodem w parameter, Flow Control
  980.           Chapter 14
  981.  
  982.       Functions are operations supported by ZCOMM, such as a dir, type, s,
  983.           r, or t (term) command.  A command may set or reset term options,
  984.           change a parameter, or perform a function.
  985.  
  986.       Host Operation allows remote access of files and programs.
  987.  
  988.       Iff If and only if.
  989.  
  990.       Integrity in a data transfer protocol refers to the ability of the
  991.           protocol to guarantee a correct data transfer provided both sender
  992.           and receiver report a successful transfer.  Integrity is a
  993.           different measure of a file transfer protocol than robustness,
  994.           which is a measure of a protocol's ability to complete the
  995.           requested transfers in the presence of errors, independent of the
  996.           probability of undetected errors.
  997.  
  998.       Kermit ia an error correcting batch file transfer protocol developed
  999.           at Columbia University and elsewhere.  The Kermit protocol
  1000.  
  1001.  
  1002.       (C) 1993 Omen Tech Inc                         Chapter 6 Rosetta Stone
  1003.  
  1004.  
  1005.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1006.       ZCOMM User Manual                                                   18
  1007.  
  1008.           supports text and binary file transfers with many mainframe
  1009.           computers whose hardware and operating software preclude
  1010.           implementation of high performance protocols.
  1011.  
  1012.       Line Hit A burst of noise on a telephone line may generate modem data
  1013.           errors.  A single "line hit" may garble dozens of characters.
  1014.           ZCOMM's Error Containment(TM) technology may be used to reduce the
  1015.           number of characters garbled by line hits suffered in terminal
  1016.           emulation data capture.
  1017.  
  1018.       N.B. Nota Bene, Latin for "note well" or "take notice".
  1019.  
  1020.       Options Options apply to the Kermit, s, sx, sb, s7, st, r, rx, r7, rb,
  1021.           and rc protocol file transfer commands.
  1022.  
  1023.       q.v. Quod Vide is Latin for "which see", an invitation to consult
  1024.           information on the subject mentioned.
  1025.  
  1026.       Pathname is a complete file name, optionally including disk and/or
  1027.           directory names.
  1028.  
  1029.           EXAMPLE: c:/ZCOMM/PHODIR.t
  1030.  
  1031.  
  1032.       Pathspec ... A pathspec consists of zero or more pathnames.
  1033.  
  1034.           Unambiguous and ambiguous (with wildcard characters) pathnames may
  1035.           be specified in any combination.  The wildcard filename characters
  1036.           * and ?  are allowed as described in the IBM DOS manual chapter
  1037.           "Global Filename Characters".  In DOS, only the filename portion
  1038.           of the pathname may contain wildcards.
  1039.  
  1040.           EXAMPLE: src/cmd/*.c is legal; src/*/foo.c is not.
  1041.  
  1042.  
  1043.           On 32 bit Unix systems, ZCOMM expands "*" and "?" the way the
  1044.           shell does.  All the shell wildcards may be used including
  1045.           multiple wildcards, wildcards in directories, and ranges.  ~user
  1046.           expands to the login directory of user, and ~ expands to your home
  1047.           directory.  In addition, `command` takes the output of command as
  1048.           a series of pathnames.
  1049.  
  1050.           EXAMPLE: dir */[a-i]* displays all files starting with "a" to "i"
  1051.           in all subdirectories immediately below the current directory.
  1052.  
  1053.  
  1054.           An empty pathspec represents all files in the current directory on
  1055.           the current disk.  A disk identifier without any file names
  1056.           represents all files on that disk's current directory.  A
  1057.           directory pathname expands to all files in the specified
  1058.           directory.
  1059.  
  1060.  
  1061.       (C) 1993 Omen Tech Inc                         Chapter 6 Rosetta Stone
  1062.  
  1063.  
  1064.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1065.       ZCOMM User Manual                                                   19
  1066.  
  1067.           Sequences of the form %svar are replaced by the value (possibly
  1068.           empty) of the string parameter svar.  If svar is not a string
  1069.           parameter, no substitution is made.
  1070.  
  1071.           A pathspec may contain any combination of the above, separated by
  1072.           spaces or tabs.
  1073.  
  1074.           If pathspec includes a disk specifier (such as a: or b:), ZCOMM
  1075.           checks the disk specifier against the permissible disk specifiers
  1076.           in the disks string parameter
  1077.  
  1078.           The various filename expansions are especially useful in the
  1079.           context of commands such as wc, sum, crc, find, sb, and sz.  For
  1080.           example, wc applies to all files in the current directory, and
  1081.           wc dir applies to all files in dir.
  1082.  
  1083.           ZCOMM pathnames may use / or \ to delimit directories.
  1084.  
  1085.       Regular Expressions control pattern matching and grouping of text by
  1086.           the ss and egrep commands.  "Magic" characters specify the pattern
  1087.           matching and grouping processes.
  1088.  
  1089.       Remote refers to the machine or terminal with which ZCOMM is
  1090.           communicating.  This could be a direct RS-232 connection to a
  1091.           local terminal, micro, mini, or mainframe, or a timesharing system
  1092.           accessed through a modem and a global packet switched network.
  1093.  
  1094.       Restraint See "Flow Control" above.
  1095.  
  1096.       Restricted For security reasons, ZCOMM is restricted to prevent
  1097.           unauthorized dial-in users from accessing private data or crashing
  1098.           the system.  Certain commands are illegal when ZCOMM is
  1099.           restricted, and only specified disk drives and directories may be
  1100.           accessed.
  1101.  
  1102.       Review Function Characters output from the remote may be paged and
  1103.           searched online with the review function.  This data may also be
  1104.           cut and pasted to disk files.
  1105.  
  1106.       Robustness in a file transfer protocol refers to the protocol's
  1107.           ability to complete transfers in the presence of errors induced by
  1108.           line noise or other sources.  Robustness is a different measure of
  1109.           a file transfer protocol than integrity, a measure of the
  1110.           probability of correct data transfer given a successful completion
  1111.           of the transfer process.
  1112.  
  1113.       Script A script is a set of commands that control dialogues with the
  1114.           user or a remote system.
  1115.  
  1116.       Script Level refers to the degree of nesting of scripts.  Level 0 is
  1117.           called by the user directly, and each higher level is executed by
  1118.  
  1119.  
  1120.       (C) 1993 Omen Tech Inc                         Chapter 6 Rosetta Stone
  1121.  
  1122.  
  1123.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1124.       ZCOMM User Manual                                                   20
  1125.  
  1126.           a gosub or other command from the previous level.
  1127.  
  1128.       Shell Escape is a DOS command or program called as a subroutine from
  1129.           ZCOMM via a DOS Gateway.  The phrase "shell escape" comes from the
  1130.           Unix(TM) Operating System, whose command interpreter is called
  1131.           "the shell".
  1132.  
  1133.       Soft Keys Strings or commands may be assigned to the Soft Keys with
  1134.           set commands, including those in the telephone directory "setup"
  1135.           entry executed each time ZCOMM starts.  ZCOMM recognizes the forty
  1136.           function key codes produced by the function keys F1 to F12.  FS1
  1137.           to FS12 are obtained with a Shift key, FC1 to FC12 are obtained
  1138.           with the Ctrl key, and FA1 to FA12 are obtained with the Alt key.
  1139.           The cursor keys and extra function keys on 101 key Extended
  1140.           Keyboards are also recognized.
  1141.  
  1142.           Strings or commands may be assigned to BS, ESC, Ins, Del, Home,
  1143.           End, Up, Down, Left, Right, PgUp, and PgDn, overriding their
  1144.           normal functions in the term function.
  1145.  
  1146.       String Some commands take a string argument.  If a string argument
  1147.           contains spaces, tabs, and a semicolon, it must be enclosed by
  1148.           double quotes (shift single quote on the IBM PC keyboard).
  1149.           Control characters may be included in strings with character
  1150.           escapes similar to those used by the C Programming Language.
  1151.  
  1152.       Term Function ZCOMM's Term Function provides the conversational
  1153.           "connection" between the user and the remote.  The term function
  1154.           captures data from the remote into ZCOMM's circular buffer from
  1155.           whence it may be displayed, printed, stored in a disk file, or
  1156.           searched, cut and pasted by the review function.
  1157.  
  1158.       Term Options Many options are available to modify the way the term
  1159.           function receives, displays, transmits, and stores data.
  1160.  
  1161.       Upload is a transfer of data from your computer up to the host system.
  1162.  
  1163.       Wild Card Many commands allow wild card file names in their pathspec
  1164.           (q.v.).
  1165.  
  1166.       Writing When a receive file is open as a result of a create or t
  1167.           filename command, data in the circular buffer is written out to
  1168.           the receive file when the circular buffer fills up or when a w or
  1169.           ALT-W command is given.
  1170.  
  1171.       XMODEM The Ward Christensen file transfer protocol uses 128 byte
  1172.           packets, one byte control messages, and a one byte arithmetic
  1173.           checksum.
  1174.  
  1175.       XMODEM/CRC A synonym for the enhanced Ward Christensen XMODEM protocol
  1176.           using a Cyclic Redundancy Check (CRC-16).  Newer programs support
  1177.  
  1178.  
  1179.       (C) 1993 Omen Tech Inc                         Chapter 6 Rosetta Stone
  1180.  
  1181.  
  1182.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1183.       ZCOMM User Manual                                                   21
  1184.  
  1185.           CRC-16 for better data integrity, but reliability is still
  1186.           compromised by one byte control messages.
  1187.  
  1188.       XMODEM-1k XMODEM protocol with 1024 byte data packets, CRC-16, and one
  1189.           byte control messages, sometimes incorrectly called ymodem.
  1190.  
  1191.       YMODEM YMODEM is a batch file transfer protocol with pathname, date,
  1192.           file length and other file data in block 0, CRC-16 default, and
  1193.           optional 1024 byte packets.  Many programs claiming to support
  1194.           YMODEM actually use XMODEM with 1024 byte blocks; use ZCOMM's sx
  1195.           -k and rx commands with these XMODEM mutants.
  1196.  
  1197.       XOFF, XON ASCII control characters control the flow of data.  XOFF
  1198.           (Ctrl-S) stops and XON (Ctrl-Q) resumes the flow of data.  Chapter
  1199.           37 provides an ASCII code chart with the names for the control
  1200.           characters.
  1201.  
  1202.       ZCOMM is a shareware (User Supported) subset of PCDOS Professional-
  1203.           YAM.
  1204.  
  1205.       ZMODEM An advanced file transfer protocol with simplified human
  1206.           interface, crash recovery, high speed streaming, sensitive 32 bit
  1207.           CRC, command download, security features, and important file
  1208.           management functions.
  1209.  
  1210.       {arg1 | arg2} One of the arguments separated by | is required.
  1211.  
  1212.       []  Optional argument.
  1213.  
  1214.       *   The special symbol * denotes features not included in ZCOMM.  **
  1215.           Denotes features not included in userialized (unregistered) copies
  1216.           of ZCOMM.
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.       (C) 1993 Omen Tech Inc                      Chapter 6 Installing ZCOMM
  1239.  
  1240.  
  1241.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1242.       ZCOMM User Manual                                                   22
  1243.  
  1244.       7.  INSTALLING ZCOMM
  1245.  
  1246.       If you have registered your copy of ZCOMM, make yourself a working
  1247.       copy of the ZCOMM distribution disk using the DOS diskcopy command.
  1248.       Keep the distribution disk in a safe place away from nasty killers
  1249.       such as disk drives, displays, computers, magnets, motors, and coffee
  1250.       cups.  The only time the distribution diskette should be out and about
  1251.       is when you are cloning your working copies.
  1252.  
  1253.  
  1254.       7.1  Installation from Registration Disk
  1255.  
  1256.       Before installing ZCOMM, you may wish to create a directory for the
  1257.       ZCOMM files.  If so, you must include this dorectory in the DOS PATH.
  1258.       Otherwise the files may be extracted to the root directory.
  1259.  
  1260.       The ZCOMM software files are contained in the ZCOMMEXE.ZIP and
  1261.       ZCOMMHLP.ZIP archives on the distribution disk.  Use a standard
  1262.       "unzip" program such as PKUNZIP to extract files from these archives.
  1263.  
  1264.       The putsnp program inserts your ZCOMM Serial-Number-Password (ZSNP)
  1265.       into your working copiy of ZCOMM.  Installing a legal serial number
  1266.       suppresses the pause after the opening message, enlarges the circular
  1267.       buffer, and enables new commands.  The putsnp program prompts for your
  1268.       Serial/Number/Password (SNP) of the form X123456789.  Putsnp checks
  1269.       for keyboarding mistakes and then verifies that you understand and
  1270.       agree to the licensing conditions.  When you understand and agree to
  1271.       the licensing conditions, respond with yes (not just y).
  1272.  
  1273.       Then putsnp prompts for the name of a file to insert the serial number
  1274.       into.  This should be a ZCOMM.EXE file that you have transferred to a
  1275.       scratch disk, or to an appropriate directory on your hard disk.  Do
  1276.       not write on the distribution diskette unless a nuclear attack is in
  1277.       progress.
  1278.  
  1279.       After inserting the serial number in the given file, putsnp asks if
  1280.       you wish to change the default value for the phone directory pathname
  1281.       (string parameter phones).  This is normally /PHODIR.t.  If you wish
  1282.       to keep the phones file elsewhere, answer "yes".[1] Putsnp then
  1283.       searches for the location in your copy of ZCOMM that contains this
  1284.       information.  When found, you may enter a new pathname,[2] up to 64
  1285.       characters.
  1286.  
  1287.  
  1288.       __________
  1289.  
  1290.        1. The default value may also be overidden with the PHONES DOS
  1291.           environment variable.
  1292.  
  1293.        2. Such as c:/zcomm/PHODIR.t.
  1294.  
  1295.  
  1296.  
  1297.       (C) 1993 Omen Tech Inc                      Chapter 7 Installing ZCOMM
  1298.  
  1299.  
  1300.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1301.       ZCOMM User Manual                                                   23
  1302.  
  1303.       Afterwards, you should copy the help processor files YHP.EXE and
  1304.       ZMANH.HLP from the disk.
  1305.  
  1306.  
  1307.       7.2  Installation from ZCOMM*.ARC
  1308.  
  1309.  
  1310.       If you are using the software provided in ZCOMM*.ARC, be sure to save
  1311.       the original files for backup, and pass them on to your friends to
  1312.       fill their communications needs.  There are currently three ZCOMM
  1313.       archive files:
  1314.  
  1315.         + ZCOMMEXE.ARC contains the executable program and demonstration
  1316.           files.
  1317.  
  1318.         + ZCOMMDOC.ARC contains this documentation.
  1319.  
  1320.         + ZCOMMHLP.ARC contains ZCOMM's tree structured help file and random
  1321.           access flash-up help processor.
  1322.  
  1323.  
  1324.       7.3  Installation Continued
  1325.  
  1326.  
  1327.       The second order of business is to read this manual.  There is just no
  1328.       way you can get your money's worth out of ZCOMM without reading, or at
  1329.       least carefully scanning, this manual.  After all, didn't you get
  1330.       ZCOMM because you needed something more powerful than that cumbersome,
  1331.       unreliable, brain-damaged menu driven crock you've been using?
  1332.       (Perhaps you shouldn't answer that question just yet ...)
  1333.  
  1334.       You can then edit PHODIR.t to suit your own needs by inserting
  1335.       directory entries for the systems you wish to call and changing the
  1336.       phone numbers, account numbers, and passwords on the "standard"
  1337.       entries for popular timesharing services that you have accounts with.
  1338.       Be sure to check the setup entry and make any changes you feel
  1339.       appropriate.  Once you have the "feel" of ZCOMM, you will want to
  1340.       remove the automatic menu invocation at the end of the setup directory
  1341.       entry.
  1342.  
  1343.       Chapter 10 gives a line by line tutorial for setting up your telephone
  1344.       directory assuming you are using a standard modem.
  1345.  
  1346.       If you are using a computer that runs at non standard clock rates
  1347.       (e.g., 8 mHz 8088 instead of 4.77 mHz) or with an enhanced CPU chip
  1348.       (NEC V20), you will need to set special values for the a and b numeric
  1349.       parameters as described in Chapter 24.
  1350.  
  1351.       **** WARNING **** Although ZCOMM is well behaved as communications
  1352.       programs go, some memory resident programs, special keyboard
  1353.       modifiers, print spoolers, or special display drivers, may cause
  1354.  
  1355.  
  1356.       (C) 1993 Omen Tech Inc                      Chapter 7 Installing ZCOMM
  1357.  
  1358.  
  1359.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1360.       ZCOMM User Manual                                                   24
  1361.  
  1362.       problems.
  1363.  
  1364.       **** WARNING **** Since ZCOMM uses interrupts to read data from the
  1365.       serial ports, each serial port must be strapped for its proper
  1366.       interrupt vector.  Some communications programs assign both IRQ3 and
  1367.       IRQ4 while operating, so they will operate even if the serial ports
  1368.       are not strapped properly.  Since ZCOMM only assigns the interrupt
  1369.       vector of the port in use, incorrect IRQ level strapping will crash
  1370.       ZCOMM.  Check the serial port addresses and vectors with the
  1371.       information given ith the port command in Chapter 19 if you encounter
  1372.       trouble starting ZCOMM.
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.       (C) 1993 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1416.  
  1417.  
  1418.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1419.       ZCOMM User Manual                                                   25
  1420.  
  1421.       8.  UNLEASHING THE MODEM
  1422.  
  1423.       8.1  Hardware Interface
  1424.  
  1425.       ZCOMM accesses serial ports at the standard IBM COM1 and COM2
  1426.       addresses.  Zcomm also has definitions for COM3-COM18 as described
  1427.       under the port command.  The portx command may be used to access
  1428.       8250/16450/16550A type serial ports at non standard addresses.
  1429.  
  1430.       When a port is selected, a quick hardware check is made to verify the
  1431.       existence and minimal functionality of the port.  If this test fails,
  1432.       the message Port N Defective is displayed.  An incorrect port switch
  1433.       or strap (jumper) configuration is the usual cause of this message.
  1434.  
  1435.       This check does not guarantee the port is connected to the proper IRQ
  1436.       line.  If the port is not configured to use the proper IRQ line, Zcomm
  1437.       will not talk to the port, and the computer may lock up.
  1438.  
  1439.       Some 8250 UART devices (used by serial interface adapters and internal
  1440.       modems) do not respond correctly when the software turns the
  1441.       transmitter interrupts on and off.  High speed communications programs
  1442.       such as ZCOMM require properly functioning UART chips.  We recommend
  1443.       the National Semiconductor NS16550AN/NS16550AFN.
  1444.  
  1445.       8.2  MODEM environment variable
  1446.  
  1447.       The advanced dialing scripts use two script subroutines to generate
  1448.       dialing commands for your specific modem.  The top level routine is
  1449.       the adial subroutine in the main phones.t file.  The top level routine
  1450.       handles alternate number lists and operations pertinent to all modems.
  1451.  
  1452.       Adial uses the MODEM environment variable to identify the disk file
  1453.       containing the modem specific dialer.  The value inherited from the
  1454.       environment may be overridden with a set command.  Adial searches for
  1455.       this file in the directory specified by the lib string variable.  The
  1456.       following dialer files are currently provided in dialers.zoo.
  1457.       Additional dialers will be described in dialers.doc, part of the
  1458.       dialers.zoo archive.
  1459.  
  1460.       The phomast.t starter script can also be made to use the advanced
  1461.       dialers by uncommenting the following lines:
  1462.  
  1463.            : set mcommand "gosub adial"       : select advanced dialer
  1464.            : if "!%MODEM" set MODEM hu96.t         : for modem specific
  1465.       dialer
  1466.  
  1467.       The second line above should be changed to suit your modem.
  1468.  
  1469.  
  1470.       ax9624.t    MicroCom AX/9624c with MNP Class 6.  This modem includes a
  1471.                   pseudo full duplex 9600 bps speed.
  1472.  
  1473.  
  1474.       (C) 1993 Omen Tech Inc                  Chapter 8 Unleashing the MODEM
  1475.  
  1476.  
  1477.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1478.       ZCOMM User Manual                                                   26
  1479.  
  1480.       cs3820.t    AT&T Paradyne Comsphere 3820, DataPort Modem
  1481.  
  1482.       hst.t       U S Robotics HST Dual Standard
  1483.  
  1484.       hu96.t      Hayes V series Ultra Smartmodem 9600 (v.32/v.42)
  1485.  
  1486.       hv96.t      Hayes V series Smartmodem 9600
  1487.  
  1488.       mmv32b.t    Multitech MultiModem V32 with V.32bis.
  1489.  
  1490.       mmv32.t     Multitech MultiModem V32 with MNP.
  1491.  
  1492.       mm224.t     Multitech MultiModem 224 without MNP.  This dialer
  1493.                   supports many 2400 bps modems with little or no
  1494.                   modification.
  1495.  
  1496.       mm224e.t    Multitech MultiModem 224E with MNP.
  1497.  
  1498.       sm1200.t    Hayes Smartmodem 1200
  1499.  
  1500.       supra.t     Supra FAXModem V.32bis
  1501.  
  1502.       tb.t        Telebit TrialBlazer
  1503.  
  1504.       Selecting the proper modem type takes two steps.  First the file name
  1505.       for the desired dialer must be specified in your DOS (or Unix)
  1506.       environment.
  1507.       NB.  The following must be entered without extra spaces.
  1508.  
  1509.       EXAMPLE: C>set MODEM=mm224e.t      (DOS)
  1510.  
  1511.  
  1512.       EXAMPLE: $ MODEM=mm224e.t; export MODEM      (Unix)
  1513.  
  1514.  
  1515.       Second, the Zcomm lib string variable must be set in the phones.t
  1516.       setup phone directory entry or in phones.ts.
  1517.  
  1518.       EXAMPLE: set lib "C:/ZCOMM"      (DOS)
  1519.  
  1520.  
  1521.       EXAMPLE: set lib "/usr/lib/yam" (Unix default)
  1522.  
  1523.  
  1524.       When setting up for a particular modem type, be sure to configure the
  1525.       modem's switches and Non Volatile RAM (NVRAM) for use with ZCOMM.  If
  1526.       nonstandard NVRAM settings interfere with ZCOMM's initialization scrip
  1527.       for that modem, you may have to manually restore the NVRAM contents to
  1528.       the factory default.  The supplied scripts expect to see the factory
  1529.       default VERBAL RESULT CODES (not result digits).
  1530.  
  1531.  
  1532.  
  1533.       (C) 1993 Omen Tech Inc                  Chapter 8 Unleashing the MODEM
  1534.  
  1535.  
  1536.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1537.       ZCOMM User Manual                                                   27
  1538.  
  1539.       The adial dialing script supports a number of modems under control of
  1540.       the MODEM environment variable.
  1541.  
  1542.  
  1543.       8.3  New and Improved Modems
  1544.  
  1545.       Modem manufacturers are constantly refining their products, adding new
  1546.       features and making subtle subtle changes in existing features.  If
  1547.       your modem is not listed in one of the following subchapters, please
  1548.       read all the subchapters and use the suggestions that apply to modems
  1549.       similar to yours.
  1550.  
  1551.       To obtain the full performance your modem provides, you can create a
  1552.       dialer optimized for your modem.  Copy the dialer script for a similar
  1553.       modem into a new file.
  1554.  
  1555.       Next, edit the initialization strings in the dialing scripts to take
  1556.       advantage of new modem features.
  1557.  
  1558.       8.4  Pulse Dialing
  1559.  
  1560.       If your telephone line requires rotary (pulse) dialing, set mprefix to
  1561.       ATDP with a command in the setup telephone directory entry.  This
  1562.       procedure is detailed in Chapter 9.
  1563.  
  1564.       8.5  Cellular Radio
  1565.  
  1566.       Some modems (AT&T Keep In Touch) have special settings to optimize
  1567.       operation when making calls over cellular radio.  The call cellular
  1568.       command sets the string parameter cellular that instructs certain
  1569.       dialers to optimize operation for cellular radio.
  1570.  
  1571.       Some modems have special options to enhance operation when accepting
  1572.       calls over cellular raidio or other difficult, unstable connections.
  1573.       The command: call init,cela sets these parameters on some dialers.
  1574.  
  1575.       Please check the source code for the dialer you are using for cellular
  1576.       support.
  1577.  
  1578.       8.6  MNP, V.42, X.PC, AFT
  1579.  
  1580.       More and more modems support one or more error correcting link level
  1581.       protocols such as MNP and V.42.  Modem to modem link level protocols
  1582.       correct most transmission errors reducing the frequency of garbled
  1583.       text and file transfer retries.  Modern link level protocols increase
  1584.       transmission speed by eliminating start/stop bits and redundant
  1585.       information.
  1586.  
  1587.       When MNP is enabled, the calling modem sends control characters to
  1588.       interrogate the answering modem for MNP.  These characters can prevent
  1589.       logging in to some timesharing systems, packet switched networks, and
  1590.  
  1591.  
  1592.       (C) 1993 Omen Tech Inc                  Chapter 8 Unleashing the MODEM
  1593.  
  1594.  
  1595.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1596.       ZCOMM User Manual                                                   28
  1597.  
  1598.       bulletin boards.  Non streaming protocols such as XMODEM, YMODEM, and
  1599.       Kermit usually give faster transfers without the delays introduced by
  1600.       MNP and other link level protocols.  Accordingly, ZCOMM's dialing
  1601.       scripts are designed to place calls with MNP disabled by default.
  1602.  
  1603.       No modifier is used for AFT, V.42, or V.42bis link protocols.  We have
  1604.       not experienced log-in or throughput problems with these protocols, so
  1605.       we made them the default.
  1606.  
  1607.       There are unfortunately exceptions to every rule.  A few modems enable
  1608.       V.42 only when MNP is commanded.  The dialers for these modems default
  1609.       to MNP and V.42 enabled, and allow the /dir dial modifier to disable
  1610.       error correction.
  1611.  
  1612.       The dialer scripts support one or more of the following modifiers:
  1613.  
  1614.       /300     Force a connection at 300 bps.  Dropping down to 300 bps may
  1615.                be necessary to get a reliable connection in the Oregon Rain
  1616.                Forest.
  1617.  
  1618.       /1200    Force a connection at 1200 bps.
  1619.  
  1620.       /2400    Force a 2400 bps connection.
  1621.  
  1622.       /9600    Force a 9600 bps connection.
  1623.  
  1624.       /nop     Suppress the detection of call progress reporting.  This may
  1625.                be used to prevent the modem from misinterpreting an unusual
  1626.                ringing sound as a busy signal.
  1627.  
  1628.       /c       Enable modem compression.
  1629.  
  1630.       /fast    Force a high speed PEP connection (refuse a slow speed
  1631.                connection).
  1632.  
  1633.                EXAMPLE: 123-4567/fast
  1634.  
  1635.  
  1636.       /man     Some modems incorrectly abandon a call attempt when they
  1637.                "hear" sounds they aren't programmed to understand.  For
  1638.                example, some TrailBlazer modems abort the call with a
  1639.                spurious "NO CARRIER" message when they hear the sound of the
  1640.                telephone "ringing". If that doesn't dump the call, the
  1641.                TrailBlazer may dump the call when the answering modem emits
  1642.                an echo suppressor disabling tone before sending the standard
  1643.                Bell 103 answer tone.  Under these circumstances the only
  1644.                solution is to listen to the sounds yourself and tell the
  1645.                modem exactly when to start listening.  With the /man
  1646.                modifier, the modem remains in command mode after dialing the
  1647.                phone number and ZCOMM enters the term function to display
  1648.                messages from the modem.  When you hear the called modem's
  1649.  
  1650.  
  1651.       (C) 1993 Omen Tech Inc                  Chapter 8 Unleashing the MODEM
  1652.  
  1653.  
  1654.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1655.       ZCOMM User Manual                                                   29
  1656.  
  1657.                answer tone, hit F1 to exit the term function.  The dialing
  1658.                script then sends an "ATO" to the modem to attempt a normal
  1659.                data connection.  Some practice may be necessary before you
  1660.                get the right timing.  If you hit F1 too late the answering
  1661.                modem may timeout before the modems can handshake and enter
  1662.                data mode.
  1663.  
  1664.       /dir     Use direct connection without speed buffering and/or error
  1665.                control (MNP, V.42, etc.).
  1666.  
  1667.       /cell    Adjust the modem for best operation over cellular radio
  1668.                connections.
  1669.  
  1670.       /mnp     Require MNP link level connection.  Do not connect if MNP
  1671.                fails.
  1672.  
  1673.                EXAMPLE: 123-4567/mnp
  1674.  
  1675.  
  1676.       /mnp_s   Require MNP link level connection, use software flow
  1677.                control.[1] Do not connect if MNP fails.
  1678.  
  1679.       /a_mnp   Request MNP link level connection.
  1680.  
  1681.       /a_mnp_s Request MNP link level connection, use software flow control.
  1682.  
  1683.       /xmodem  Enable "XMODEM spoofing" on Trailblazer modems. (Not
  1684.                recommended)
  1685.  
  1686.       /kermit  Enable "Kermit spoofing" on Trailblazer modems. (Not
  1687.                recommended)
  1688.  
  1689.       /v22     Use V.22 modulation on a 1200 bps call.
  1690.  
  1691.       /c:modifier Optional modem dependent modifier string
  1692.  
  1693.  
  1694.       8.7  High Speed Modems
  1695.  
  1696.       The new generation of high speed dial-up modems presents special
  1697.       challenges to users and system integrators.
  1698.  
  1699.       These modems transmit data at speeds from 110 to 38400 or more bits
  1700.       per second.  This range of speeds poses special problems communicating
  1701.  
  1702.  
  1703.       __________
  1704.  
  1705.        1. Software flow control in the modem is not compatible with XMODEM,
  1706.           YMODEM, Sealink, Clink, or WXMODEM.
  1707.  
  1708.  
  1709.  
  1710.       (C) 1993 Omen Tech Inc                  Chapter 8 Unleashing the MODEM
  1711.  
  1712.  
  1713.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1714.       ZCOMM User Manual                                                   30
  1715.  
  1716.       between the computer and the modem.  Lower speed modems examine the
  1717.       traditional "AT" command prefix bit by bit to lock onto the computer's
  1718.       transmission speed instantly.  Many modems which recognize commands at
  1719.       widely varying speeds can not use this technique.  A number of
  1720.       alternate techniques have been developed, each with its own advantages
  1721.       and problems.
  1722.  
  1723.         + Lock the interface to the highest transmission rate.  This avoids
  1724.           the programming required to synchronize the modem's and computer's
  1725.           speeds.  Flow control must be used when the interface speed is
  1726.           locked to prevent the computer from sending data more rapidly than
  1727.           the modem can buffer and transmit it.  This local flow control is
  1728.           usually accomplished with hardware signals.  When such an
  1729.           arrangement is used to communicate over networks that must assert
  1730.           their own flow control (with XON and XOFF), data flow regulation
  1731.           must respond to both hardware (RTS) and software (XOFF) signals.
  1732.           The handshake both command should be used whenever the modem's
  1733.           interface speed is locked and transmission over networks or to
  1734.           timesharing systems is desired.
  1735.  
  1736.           Locking the interface speed to 9600 or 19200 bps while
  1737.           communicating at 1200 and 2400 bps should be avoided unless all
  1738.           links in the transmission path have low error rates.
  1739.  
  1740.           Most modems do not recognize XOFF characters from the remote
  1741.           computer, so characters stored in the modem's buffer will be
  1742.           transmitted for a period of time after an XOFF is received.  This
  1743.           causes loss of data with some computer services.
  1744.  
  1745.           When the interface speed is locked at a higher speed than the
  1746.           actual data transmission, an excessive amount of data may be
  1747.           stored in the modem's memory awaiting transmission.  This is
  1748.           inefficient when a streaming file transfer protocol is used
  1749.           because the data stored in the buffer must be drained before error
  1750.           recovery can commence.  The ZMODEM b and w numeric parameters
  1751.           should be used to manage the modem's data storage.
  1752.  
  1753.  
  1754.         + Autobaud to adjust the modem and computer speed.  With this
  1755.           method, the modem is optioned to enter a search mode whenever it
  1756.           becomes idle.  The dialing script calls the waketb phone directory
  1757.           subroutine to train the modem to the computer's transmission
  1758.           speed.  The waketb subroutine may be optimized for the particular
  1759.           modem used.
  1760.  
  1761.           After dialing or answering a call, the modem handshakes with the
  1762.           remote modem and reports the connect speed with a message such as
  1763.           "CONNECT 1200" or "CONNECT FAST".  The dialing script recognizes
  1764.           the string, and sets the computer to the correct speed.  If the
  1765.           connection is made at high speed, the dialing script may need to
  1766.           enable hardware flow control with a handshake command.
  1767.  
  1768.  
  1769.       (C) 1993 Omen Tech Inc                  Chapter 8 Unleashing the MODEM
  1770.  
  1771.